Cache Index v2.3 July 1996 - Read Me File

Cache Index is distributed as Freeware to anyone who finds it useful. The 
author (David Griffiths) retains the copyright to the software. Any comments 
or feedback will be appreciated.  I can be contacted by email at:  
   
    dgriffo@ozemail.com.au

If you would like to be placed on a mailing list to be advised of updates, 
send an email to the above address and put 'SUBSCRIBE UPDATES' as the 
subject.

More comprehensive information can be viewed from within Netscape by opening 
the file CINDEX.HTM.

Cache Index is a program that makes it easy to view the files stored in 
Netscape's (tm) cache. This means that you can read pages at your leisure 
when you are off line. It also makes it easy to 'borrow' icons and graphics 
for use on your own page if you are developing one. It will work with Win 3.1 
and Win 95.

How does it work?
When Netscape (tm) is used to surf the Web, it stores all the pages it 
receives (text and graphics) in its cache directory. You can configure the 
maximum size of the cache that Netscape keeps and how long it leaves the 
files there before it purges them (see Netscape Options/Preferences). The 
cache indexer scans the  cache and produces a series of HTML files, with a 
master index page called A-INDEX.HTM.  The HTML pages contain links to each 
of the files in the cache. Cache Index breaks the cache into managable pages 
containing no more than 30 text page links or 13 graphics.

How to install Cache Index
- Put CINDEX.EXE into a suitable directory 
   (say the Netscape directory or Netscape Cache directory))
   (possibly C:\NETSCAPE or C:\NETSCAPE\CACHE )
- Put CINDEX.HTM, CI.GIF & S2C.GIF into the Netscape Cache directory. 
- Create a Program Manager/Desktop icon for Cache Index
- Set the Working Directory as the Netscape Cache directory.

How to run Cache Index for Netscape V1.x
- Close Netscape
- Run Cache Index from the icon.
- Run Netscape and Open the file A-INDEX.HTM in the cache directory.  
That's it!

How to run Cache Index for Netscape V2
- use about:cache in the Netscape Location window (or Open Location)
- save the page this creates in the CACHE directory as ACACHE.HTM
- run Cache Index from the icon (Netscape can stay open)
- Open the file A-INDEX.HTM in the cache directory.

Options
There are a few command line options that can be used:
-g eliminates graphics from the index
-t eliminates text from the index
using both -g and -t together makes a very brief index!
-p  does not put a <p> after each graphic, forcing a new line
-s  does not sort the index into text first
-h  removes the Page Titles (which makes it quicker but less readable.)
+d  scans a directory for M0... files, when no FAT file is available
+u  adds the URL for text files
+r  renames all graphics files to their original name (.GIF etc), note this
    effectively removes them from the cache for future on line use.
l28 sets the maximum number of items on a page

This version of Cache Index is written for Netscape versions 1.1N through
to v2.02.

Directory Scan
There is an option (+d) which can be used to make Cache Index scan a
directory looking for Netscape cache files and create an index of them. This
option is intended for when there is no FAT file available. eg if someone has 
saved a bunch of files out of a cache directory.  There are several 
limitations to this mode: firstly because there is no FAT file, it is not 
possible to determine the original URL of each file. Also it is necessary for
Cache Index to make a guess about the file type based on the file extension.
At present it assumes .GIF and .JPG are graphics files and anything else is
text. It it gets it wrong, it is not a major problem, it just means the file
ends up in the wrong list. Another limitation is that only files whose name 
starts with M0 are considered.

Netscape is a registered trade mark of Netscape Communications Corp and 
Win 3.1 and Win95 are trade marks of Micrsoft Corporation. These trade 
marks are used for identification purposes only.


What's New - see WHATSNEW.TXT for details
V2.1 added chronological sorting of entries and improved formatting of output.

V2.2 added Directory Scan (+d option)

V2.3 added minor enhancements